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INTRODUCTION 

The Symbolic Debugger interfaces with user routines, allowing the user to monitor 
and correct his program during execution. The Symbolic Debugger provides up to 
eight active breakpoints within a user routine. Accumulators, Carry and memory 
can be examined and modified during execution using simple debugger commands 
issued from the console. 

The Symbolic Debugger is tailored to the user's configuration. Thus, the symbolic 
Debugger version that a user receives will depend upon whether he has an ECLIPSE™* 
or NOVA®* computer and whether his operating system is SOS (Stand-alone Operating 
System, unmapped RDOS (Real Time Disk Operating: System), mapped RDOS, or 
RTOS (Real Time Operating System). 

RDOS users receive two versions of the Symbolic Debugger. The first enables 
interrupts during debugging and has the generic name DEBUG III (or simply DEBUG) 
and the second disables interrupts and has the generic name IDEB. The user may 
load either one of the debuggers with his program. 

The different Symbolic Debugger versions are described in Chapter 1. There are 
very slight language differences among the versions. A language comparison is given 
in Appendix A and each command description in the manual indicates for which 
versions of the Symbolic Debugger the command is valid. 



*NOVA is a registered trademark and ECLIPSE Is a trademark of Data General 
Corporation, Southboro, Massachusetts. 
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CHAPTER 1 
GENERAL DESCRIPTION 

USE OF THE SYMBOLIC DEBUGGER 

* i tert ir, ff lnrahTur and removing mistakes from a program. When a 
Debugging is the process of detecting. ^^^^^-I,. is i oad eci together with the program. 

programmer wishes to debug a program, the Symbolic Deb^y 8 ^ ^ r ^ 

s^s«;r^™=,- "s,™ sr...... «... .».-. — • 

octal format or a number of special formats may also be used. 

The ooc symb onc Debugg e r ^^^rr^-i^srr 

When the program executes, execution will ™ teto " ^ ™ , ^ programme r can then 

SYMBOLIC DEBUGGER VERSIONS 

The Symbolic Debugger that th e use, receives is, ^^^^^Z^^*^ 
his version will depend upon whether he has a ^°\™JCLWE^pute, 
or a SOS operating system, and whether ta. ope ^^ZlZT^l first interrupts during 
Z^J^^t"^^ -sS disables interrupts durbng debugging and 

has the generic name IDEB.. 



Version 

NOVA Unmapped RDOS DEBUG 
NOVA Mapped RDOS DEBUG 
ECLIPSE Unmapped RDOS DEBUG 
ECLIPSE Mapped RDOS DEBUG 

NOVA Unmapped RDOS IDEB 
NOVA Mapped RDOS IDEB 
ECLIPSE Unmapped RDOS IDEB 
ECLIPSE Mapped RDOS IDEB 

NOVA Unmapped SOS DEBUG 
NOVA Mapped SOS DEBUG 
ECLIPSE Unmapped SOS DEBUG 
ECLIPSE Mapped SOS DEBUG 



Title 



DEBUG 2 
MDEBUQj 

BDEBUG 4 
ADEBUG 

IDEB 2 
MIDEB 3 ' 
BIDEB 
AIDEB 

SADEB 

SAMDEB 
SABDEB 
SAADEB 



DEB. RB in USYS. LB 
MDEB. RB in MSYS. LB 
BDEB. RB in BSYS. LB 
ADEB.RB in ASYS.LB 

IDEB. RB 
MIDEB. RB 
BIDEB. RB 
AIDEB. RB 

SADEB. RB 
SAMDEB. RB 
SABDEB. RB 

SAADEB. RB 



Generic Type 



DEBUG 



IDEB 



SOS DEBUG 



MDEBUG and 



Numbers following the titles indicate which debuggers are supplied to a single user, (e.g 
MIOTB are supplitd to all users having a NOVA Mapped RDOS system., 

* „«,.«« Within a eiven ffroup of four versions, the Symbolic 
The versions are *™^™>£££*> % , ^Lnfalu language within the versions of the 
^r^TZTlZ^T^m differences in the commands and their interprets 

among the three generic types. 



RTOS users are supplied with the appropriate version of IDEB. 



SYMBOLIC )K':i:/;l\^ :'^v__ ..■ 

A symbolic debugging command has the general format: 




where: command-rode, is a single teletypewriter character. 

Li™.* PTeCede aU alphatetiC COmmand codes ^ Precedes certain symbolic command 
argument may be one of the following: 
s yro user symbol. 

£dr an address having any legal address format: octal or decimal integer, 

user symbol, or an expression of the form: 
x +x + x . . . 



where each x is a user symbol, or octal or decimal integer, separated from 
the following x by either + (plus) or - (minus). Decimal integers must be 
followed by a decimal point to distinguish them from octal integers. 



2. a decimal or octal integer. 

name a user symbol that names a program. 

adr_< a range of addresses from adr to 77777. 

^L z ^L n a range of addresses from adr to adr 

Commands are described in the chapters following and provide facilities to: 

Set, delete, and examine breakpoints. 

Restart execution at selected points. 

Monitor memory, accumulators and special registers. 

Enable and disable symbols available to the debugger. 

Place the debugged program in a file that can be saved. 

Perform core searches. 

Set the format of debugger output. 

Punch or print portions of the user program. 

CONVENTIONS AND SYMBOLS IN COMMAND LINES 



} IT? it" RETURN "^ 1S re P resented ^ ^ symbol ) . There is no printout 

on the teletypewriter printer when RETURN is pressed. 

1 InTh S ^ g l th n LINE FEED "^ 1S re P resented ^ ^e symbol I . There is no printout 

on the teletypewriter printer when LINE FEED is pressed. 



■■_■• ■ . '^- : ■•';'_.■ :.... :.. . .' '". ■- '.--'-I 

f Pressing the SHIFT and N keys causes the symbol t to be printed. 

$ Pressing the ESC key causes the symbol $ to be printed. 

? Pressing RIJBOUT causes the symbol ? to be printed. (See section immediately following.) 

CORRECTING TYPING ERRORS 

Pressing the RUBOLT kev causes the debugger to ignore the current command line and prints a ? . 
The programmer may then type a new command line. (Any character causing an illegal command 
line can be used; the RUBGUT convention, however, is convenient. ) 

debugger ek'u.):< REsrp:.s;.-.s 

An attempt to use an undefined symbol in a command to the debugger will result in an error 
response of 

U 

typed immediately following the command, for example: 

STAR/U *■ User references symbolic location STAR. Symbol STAR is not found 

in the program. Debugger responds with U and awaits a new command. 

All other command errors result in an error response of 

? 
Typed immediately following the command as shown in the examples following. 

yy) ;•;> -• !'-:>r.;vr t; -rn'in it:i<n of cmmMnJ. 

-I.SR' 7 ♦■ :lio'=;--i.i. a :.hcss mvc:-.li:v,; :>R. 

START+6$B? -This is an attempt to set a breakpoint at symbolic location START+6. 
The error response is printed if there are alrealy 8 breakpoints in the 

program. 

« I? * Attempt to open the interrupt register while in RDOS DEBUG (The 

register is implemented in IDEB but not in DEBUG under RDOS. ) 



* ********** 



CHAPTER 2 
MONITORING MEMORY AND SPECIAL REGISTERS 

Memory locations to the user program may be opened, examined, and modified using one of the 

following commands; 



adr/ * Open adr and print contents, 

adr ! Open adr. Do not print contents. 



where: adr may be any acceptable expression defining a location. 

When the memory location has been opened, using either the / or ! command, the user may modify 
the contents of the location and close it or he may close the location without modification. 

The user modifies the contents of a location by typeing the new contents on the same line with the 
command that opens the location. 

The user can close the open location in one of four ways: 

) Close the open location (RETURN key) 

* Close the open location and open the succeeding location (LINE FEED key) 

* Close the open location and open the proceding location (SHIFT and N keys) 



/ 



Close the open location and open the location specified by the contents of 
that location. 



Commands that open and close locations are used in all debugger versions. Some 
examples of the commands are: 



START/006011 6017 ♦ -Open symbolic location START and modify contents to 6017; open 
+762 000000 » previous location and do not modify; close the location and open the 

+761 177400 < previous location; close the location. 

+760 177400 ) 

START/006011 6017 ♦ ~ On the console, the example would appear as shown. 
+762 000000 f 
+761 177400 f 
+760 177400 



START/006017* 
START+1 001400 1 
START+2 006073) 

START/006017 
START+1 001400 
START+2 006073 



Open location START; open succeeding location; open succeeding 
location; open succeeding location and close it without opening the next. 



- On the console, the example would appear as shown. 



MONITORING MEMORY (Continued) 



1000/. RDL „KDL 1 ) - Open location. 1000 and change the contents to .RDL 1. 

Close the location, 

1000!. RDL 0) - Open location 1000 without printing the contents. Change the contents 

contents back to , RDL 0. 

1000/, RDL .RDL 1 - On the teletypewriter, the example will appear as shown. 
1000?. RDL 



open open open 

START 6017 1064J5 

4 ♦ i 

START/006017 /106415 /0400000 A 
106416 000000 ) 

START/006017 /106415 /040000 - On the console, the example would appear as shown. 
106416 000000 



MONITORING SPECIAL REGISTERS 

Special registers are locations containing program status information. They can be opened, examined, 
modified, and closed in a way similar to memory locations. A special register is normally closed by 
pressing the RETURN key, although the / or ! convention can be used where appropriate. 

Accumulators 

The command that opens an accumulator for examination and possible modification is: 



nf A 



where: n is the number of the accumulator (0-3 in the NOVA; 0-7 in the ECLIPSE computer). 
This command is used in all debugger versions. An example of the command is: 



0$A 000000 1 



All accumulators may be examined, but not modified, by the command: 



$A 



The debugger will perform a carriage return/line feed and print the number of each accumulator, 
followed by its contents. 

This command is used in all debugger versions. An example of the command is: 



$A 

000000 1 000565 2 001337 3 043131 



vo\nuK ! \(; srj i:j.\l *i >;istkks .o.minucd, 

!• I .>a? i' - _: I 1 - •i.'.t .\vjy.' i i v.ilai •,■;••< 

The four floating point accumulators may be examined, but not modified, by using the command; 



$F 



The debugger will perform a carriage return/line feed and print the number of each floating point 
accumulator, followed by its contents. 

This command is used in RDGS DEBUG and IDEB. The register is not valid in SOS DEBUG where 
the $F command causes punching of paper tape leader or trailer. An example of the command isi 



$F 

006452 1 000417 2 000000 3 106000 



Search Increment Register 

The search increment register is used in performing memory searches. (See Chapter 4 for the 
search commands. ) By default, locations in the range selected for the search by the user will be 
searched forward in memory with an increment of one location. By setting the search increment 
register, the user may adjust the increment to any number of locations between locations to be 
examined or can adjust the increment for a backward search of memory locations. 

The search increment register is opened for examination and possible modification by the com- 
mand: 



$J 



This command is used in all debugger versions. Examples of the command are: 



$J 000001 -10 


440<$S 


00440 000766 


00430 101300 


O0420 025400 


00000 006017 



- Open register and set for backward search of every 10 g locations. 

- Search from location 440 down in memory 



$J 100010 2 


102<114$S 


00102 177777 


00104 177777 


00106 000000 


00110 000005 


00112 000000 


00114 000232 



- Open register and set to search forward every second location. 

- Search from location 102 to location 114. 



MONITORING SPECIAL REGISTERS (Continued) 

Mask and Word Registers 

The mask and word registers are used in performing memory searches. (-See Chapter 6 for 
search commands.) Certain types of searches are for particular bit contents and these require 
use of the word register. 

The word register is set by the user to represent the contents for which memory is being searched. 
As the search proceeds, the contents of each location are compared with the contents of the word 
register. If they match, the location and the contents are printed out. By default, the word register 
contains 0, which allows the printout of all memory locations. 

The mask register is set by the user if he wishes to mask the contents of certain bit positions in each 
memory register during the search. If no masking is desired, the mask register is set to -1 (all ones). 
If certain bit positions are to be masked, those positions are set to zero and the unmasked positions are 

set to one. 

The contents of the mask register are ANDed with the contents of the memory location and then 
compared with the contents of the word register. By default, the mask register is set to (all bit 
positions masked). Thus, if a search required comparison of memory contents with the word 
register, which occurs if the word register is non-zero, the appropriate contents of the mask 
register must be set by the user. 

The word register is opened by issuing the command: 



$W 



The mask register is opened by issuing the command: 



$M 



These commands are used in all debugger versions. An example of the commands is: 



$W 000000 15000 - Open word register and store 15000 
$W 015000 

$M 000000 177700 - Open mask register and mask bits 0-9 



Numbers Register 

The numbers register determines whether the contents of registers will be printed out In octal or In 
decimal. By default, the numbers register is set to 0, which causes register contents to be printed 
out in octal. If the user sets the contents of the numbers register to non-zero, contents of memory 
and special registers will be printed out in decimal, i.e., as signed decimal numbers with a 
decimal point. 

The numbers register is opened for examination and modification by the command: 



$N 



Numbers Register 'Continued) 

This command is used in. all debater versions, An example of the command is; 



START/006017 - Contents of START in octal 

$N 000000 i - Change numbers register to non-zero 

START/+3087, - Contents of START in decimal 

$N -f-1. - Contents of numbers register in decimal 



Symbol Table Pointer Register 

The symbol table pointer register contains a pointer to the beginning of the User Status Table. 
In SOS loading and in RDOS background loading, this is location 402, labeled USTSS. In RDOS 
foreground loading, USTSS may be a different location. ' The symbol table pointer register is 
opened by issuing the command: 



$Y 



This command is used in all debugger versions. An example of the command is: 



- Contents of symbol table pointer register 



$Y 000402 


402/TMIN+63 


+403 


TMIN+52 


+404 


TMIN+64 


+405 


TMIN 


+406 


DEBUG 


+407 


TMIN+64 


+410 


+0 


+411 


177777 



- Examination of part of contents of the UST starting at USTSS. 
(RDOS DEBUG with minimum task scheduler.) 



Search/Punch Register 

Bit 15 of the search/punch register specifies the output device to be used in printing memory 
search results: 

Bit 15 

Print search results at the console. 

1 print search results on the line printer. 

The default setting of bit 15 is 0. 

Bit of the register specifies the output device to be used when punching portions of the user 
program as follows: 

!ht_0 

Punch output to the teletypewriter punch. 

1 Punch output to the high speed punch. 



The default setting of bit is 0. 



Search/Punch Register (Continued) 

The search/punch register is opened for examination and possible modification by issuing the following 
command; 



$H 



The register is not used in RDOS DEBUG, in IDEB only the search bit of the register is significant. 
In SOS DEBUG both the search and the punch bits are significant. An example of the command is: 



$H 000000 1 



-Open search/punch register and set bit 15 to print search output to the 
line printer. 



Interrupt Register 

The interrupt register determines whether or not interrupts are to be enabled. The register is 
used in all IDEB and SOS DEBUG versions. 

By default, the register is set to 0. which enables interrupts. (Note that in IDEB under RDOS mapping, 
the interrupts necessary for mapping are never disabled though other interrupts are.) To disable 
interrupts, the register is set to -1 (all ones). 

The interrupt register is opened for examination and possible modification by the command: 



$1 



Example: 



$1 000000 -1 



- Open interrupt register and disable interrupts. 



Task Control Block Register 

The task control block register contains the address of the task control block (TCB) of the currently 

executing task. The TCB contains status information for each task, needed by the task scheduler 
in multitasking. 

The register is opened for examination and possible modification by the command: 



$T 



The task control block register is used only for RDOS DEBUG. The command is not valid for 

IDEB or SOS DEBUG, where $T invokes the console input done register (see next page). 



$T 000740 



- Open TCB register and examine contents. 
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Console Input { TTI) Done Register 

The console input done register specifies the status of console input in bit as follows; 

'JU. 

Console input done 

1 Console input not done 

The register is opened for examination and possible modification by the command: 



$T 



The register is used in IDEB and SOS DEBUG versions. The command is not valid in RDOS DEBUG 
where $T invokes the task control block register (see previous page). Coding such as the following 
example would cause a transfer to the debugger while console input was still outstanding; 



A: SKPDNTTI 
JMP . -1 
DIAC TTI 

*■ Breakpoint set at this instruction 

$T 100000 - .Bit of the register is set to 1 



Carry and Console Output Register 

The Carry and console output done register specifies the status of the Carry flag in bit as follows: 

BitO 

Carry flag is 0. 

1 Carry flag is 1. 

Bit 15 of the register indicates the status of output to the console as follows: 

Bit 15 

Console output is not done. 

1 Console output is done. 

The default setting of bit 15 is 0. 

The Carry bit of the register is used in all debugger versions. The console output done 
bit is significant only in IDEB and in SOS DEBUG, 

The register is opened for examination and possible modification by the command: 



$C 



Coding such as the following would cause a transfer to the debugger while console output was 
still outstanding and Carry was set. 
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MONITORING SPECIAL REGISTERS (Continued) 



Carry and Console Output Register (Continued) 



B: ADCO 

DOAS TTO 
SKPDN TTO 

JMP . -1 



$C 100001 



- Breakpoint set at this instruction. 



- Bits and 15 are set to one. 



Starting Location Register 

In SOS DEBUG, the starting location register is set by the user to contain the starting address to be 
used for execution when the command $R is issued (see Chapter 3). By default, the contents of the 
starting location register under SOS DEBUG is the contents of USTSA. 

When debugging under RDOS, the starting location register will contain the contents of USTSA, address 
of the task scheduler, allowing control to be transferred to the scheduler to run the highest priority 
task. 

The starting location register may be opened for examination and possible modification by the command: 



$L 



Example: 



$L 000764 

$L 000000 4000 



- Determine address of task scheduler (RDOS DEBUG or IDEB) 

- Set starting address for $R execution to 4000 (SOS DEBUG) 



Extended Save Address Register 

The extended save address register contains the contents of User Status Table location 421, USTSV. 

USTSV points to the extended save state routine. 

The extended save address register is opened for examination and possible modification by the following 

command: 



SE 



The register is used in RDOS DEBUG and in IDEB. The command is not valid in SOS DEBUG where 
the command causes punching of an end block (see Chapter 7), An example of the command is: 

$E 002135 



***##*##*#* 
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CHAPTER 3 

BREAKPOINTS AND PROGRAM RESTARTS 

Breakpoints are key elements in debugging. Breakpoints permit the user to execute a small portion 
of his program and then check program status. 

The user sets one or more breakpoints in Ms program using a debugger command. He can then 
indicate through a command when a breakpoint should cause program execution to cease and a 
transfer be made to the debugger. In effect, when the breakpoint is encountered, the program 
instruction at which the breakpoint was set is transferred to the debugger and a J MP instruction 
to the debugger is substituted in the user program. 

Eight (10g) locations of page zero relocatable code are reserved for the eight debugger break- 
points. Any attempt to place other information in these locations and then execute will wipe 
out the user program. 

Breakpoints are assigned numeric values in reverse numeric order; for example, if the user 
sets four breakpoints in his program, the breakpoints will be numbered: 

7 
6 
5 
4 

starting with breakpoint 7. 

SETTING, EXAMINING AND DELETING BREAKPOINTS 

Setting a Breakpoint 

The format of the command that sets a breakpoint is: 



adr$B 



where: adr is the program address at which the breakpoint is set. 

This command is used in all debugger versions. An example of the command is: 



STARTSB 

START+33SB 

START+42$B 



Breakpoints should not be set at the following locations: 

1. Data words, 

2, Instructions modified during execution, 

3, Locations where interrupts cannot be delayed for relatively long times, 

4. The second word of two -word instructions. 

Examining Breakpoint Locations 

The user may wish to determine where breakpoints are currently set in his program. The com- 
mand that will cause breakpoint numbers and the locations at which they are set to be printed is: 

$B 
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SETTING, EXAMINING AND DELETING BREAKPOINTS (Continued) 

Examining Breakpoint Locations (Continued ) 

Breakpoints are printed out in descending numerical order, 

This command is used in all debugger versions. An example of the command is: 



$B 

7B START 
6B START+33 
5B START+42 



Deleting a Single Breakpoint 

The format for the command to delete a single breakpoint Is: 



n$D 



where: n is the number of a previously set breakpoint. 

The command causes a specific breakpoint to be deleted; the remaining breakpoint numbers remain 
the same, e.g., if breakpoints set are 7, 6, and 5, the command: 

6$D 
deletes breakpoint 6 while numbers assigned to the remaining breakpoints remain unchanged. 
This command is used in all debugger versions. An example of the command is: 



7$D 



Deleting All Breakpoints 

All breakpoints in a user program can be deleted by issuing the command: 



$D 



This command is used in all debugger versions. 
BREAKPOINT COUNTERS 

Associated with each breakpoint is a break proceed counter that Indicates when, during execution 
of the program, encountering that breakpoint will cause a switch to the debugger. 

When a breakpoint Is set, the break proceed counter for that breakpoint is set by default to 1, 
which is the number of times the instruction at the breakpoint will be executed before the debugger 
is reentered. This means that when the user restarts execution at that particular breakpoint, the 
instruction at the breakpoint will be executed, but the debugger will be reentered the next time 

that breakpoint is encountered. 

The user may open the break proceed counter for examination and possible modification. The 

command to open the break proceed counter is: 



n$Q 



where: n is the number of the previously set breakpoint. 
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BREAKPOINT COUNTERS (Continued) 

The contents of the break proceed counter are modified as are any register's contents by typing 
the desired contents immediately following the printout of the current contents, 

This command is used in all debugger versions. An example of the command is: 



7$Q 000001 2 



Change to two executions of the instruction at breakpoint 7 before 
reentering the debugger. 



Pi-it x ;r..\\i K;-.-> ■:::••: \ <:^\\\\ \ .'.- v 

Restarting the Program 

The debugged program may be restarted by issuing the command: 



$R 



This command is used in all debugger versions and causes restart at the contents of $L, However, 
the contents of $L differs in the debugger versions. In SOS DEBUG $L is user -set to the start of 
execution. In RDOS DEBUG $L contains the contents of USTSA, the task scheduler address, and in 
IDEB $L contains the contents of USTSA, which is the program starting address. The program will 
execute, looping through any breakpoints the number of times indicated by the break proceed counters, 
until a breakpoint is encountered, provided that a breakpoint is set. An example is. 



$R 

7B START 

006207 1 006162 2 000000 3 006162 



Restarting the Program at a Given Location 

The user may specify the location at which program execution is to resume by issuing the command* 



adr$R 



where: adr is an address within the program. 

This command is used in all debugger versions. An example of the command is: 



START+2$R 

6B START+10 

001654 1 000000 2 000000 3 000000 



Restarting the Program at a Hrcakrx-int 

When a breakpoint causes transfer to the debugger, the user issues debugging commands and can then 
restart the program execution at the breakpoint by issuing the command: 

$P 
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The program will execute, looping through the breakpoint the number of times indicated by the break 
proceed counter. When the debugger is reentered, the breakpoint and the contents of the registers 
will be printed. 

This command is used in all debugger versions. An example of the command is: 



$R 

7B START 

006207 1 006162 2 000004 3 006162 

$P 

6B START+10 

001654 1 000000 2 000004 3 000000 



The user has the option to override the contents of the break proceed counter when restarting 
execution at a breakpoint. The format of the command is: 



n$P 



where: n is the number of times the breakpoint instruction is to be executed. 
This command is used in all debugger versions. An example of the command is: 



$R 



7B START 

006207 1 006162 2 000011 3 006162 

5$P 

6B START+10 

001654 1 000000 2 000011 3 000000 



#♦###*#**#* 
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CHAPTER 4 
SEARCH COMMANDS 



AH or part of memory may be searched for a given bit configuration, and the matching addresses and 
their contents will be output at the console or on the line printer. To perform a search, the program- 
mer takes the following action: 

1. Opens the word register and places in it the desired configuration to be used in the search. 

2. Opens the mask register and sets to ones those bit positions that will contain the configura- 
tion being searched for. 

3. Opens the search increment register and sets the increment between locations to be examined. 

4. Gives a search command, indicating whether all or part of memory is to be searched for the 
desired configuration. 

The search algorithm is as follows; 

1. Contents of the address are ANDed with the contents of the mask register. 

2. The result of 1. is compared with the contents of the word register. 

3. If the comparison in 2. results in a match, the address and its contents are output. 

4. The next designated location is searched. 

The algorithm can be written as follows: 



C START J 



Search next adr 
given by current 
adr + C($J) 




Output C(adr) 
and adr 




By default, the contents of both the word and mask registers are and the search increment is +1. If 
default settings are used, all locations in the range given by the search command will be output. 

To inhibit all masking, set the mask register to -1. 

The search commands determine the range of memory to be searched. The command: 



$S 



causes all of memory to be searched. 
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SEARCH COMMANDS (Continued) 
The command: 



adr$S 



causes a search from the start of memory through adr. 
The command: 



,adr<$S 



causes a search from adr through the end of memory. 
The command: 



adr .< adr $S 



causes a search from adr through adr ? . 

These search commands are used in all debuggers. Some examples of the commands are: 



$W 000000 6017 
$M 000000 -1 
START<START-440$S 
START 006017 
START+10 006017 
START+14 006017 
START+20 006017 
START+23 006017 
START+27 006017 
START+33 006017 



- Put . SYSTM configuration in $W 

- Set $M to all ones. 

- Search range of 41 locations. 



$; 




$W 000000 LDA 2 


$M 177777 


$S 




4024 LDA 2 


10362 


LDA 2 


22026 


LDA 2 


22041 


LDA 2 


36403 


LDA 2 


42335 


LDA 2 



- Change to instruction format (see Chapter 6). 

- Put LDA 2 in $W (search on LDA 2 0). 

Check $M contents. 

- Search all memory. 



In SOS DEBUG and in IDEB, a search can be terminated by striking any key. In RDOS DEBUG, 
there is no way to terminate a search; therefore, the user should avoid possible interminable 
searches whenever possible, IDEB and SOS DEBUG also allow search output directed to the 
line printer using the $H register. 



*********** 
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CHAPTER 5 

ENABLING AND DISABLING SYMBOL RECOGNITION 

When the debugger is invoked, the symbol tables of ail programs loaded with the debugger are available 
to the debugger. The symbol tables contain all global symbols and may contain local symbols. 

Local symbols are loaded for a given program only if requested by the user, This can be done during 
loading under either RDOS or SOS, In the RLDR command line, the local switch /U must follow 
the file name of the program for which user symbols are to be loaded. See Appendix B for loading 
procedures and an example of the /U switch. 

During debugging, the user may wish to temporarily disable debugger recognition of some or all symbols 
and later re -enable recognition of the symbols, 

DISABLING ALL GLOBAL AND LOCAL SYMBOLS 



To disable debugger recognition of all symbols, the user may issue the command: 



$K 



This command is used in all debugger versions. An example of the command is: 



START /006017 - Debugger recognizes START 

$K 

START/U 



— Debugger indicates that START is an unknown symbol 



ENABLING GLOBAL AND DISABLING LOCAL SYMBOLS 

To enable or re -enable all global symbols while disabling (or continuing to disable) all local symbols, 
the user gives a command having the format: 



n$K 



where: n may be any single digit. 

This command is used in all debugger versions. An example of the command is: 



$K 

START/U - Global symbol START is disabled. 

0$K 

START/006017 - Global symbol START is re -enabled. 



At the same time that all global symbols are enabled by the n$K command, all local symbols are 
disabled. Since local symbols are often not loaded, the command is commonly used to re -enable 
all previously disabled ($K) global symbols. 
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I£.\A:iLI\(.i ALL .SYMBOLS 

All global and local symbols, removed by either n$K or $K will be re-enabled by issuing a 
command of the format: 



name| 



where: name is the name of the loaded program. 

To enable local symbols, the local /U switch must be given in the RLDR command line and 
this command must be used. 

This command is used in all debugger versions. An example of the command is: 



RLDR/D ALPHA/U 
DEB ALPHA 

ALPHAf 



REMOVING A SYMBOL FROM OUTPUT 

A given symbol may be removed from debugger output by issuing a command of the format: 



sym $K 



where: sym is the name of the symbol to be removed. 

This command only affects output; the symbol will still be recognized on input to the debugger. 

Once removed, the symbol cannot be restored to output during debugging. 

When sym is removed by this command, the debugger will replace the sym on output by an offset 
from the nearest previous symbol, provided that the substitute symbol is not more than 2000 „ 
locations removed. If there is no previous symbol within 2000 locations or if no symbols 
remain, the absolute value of the location is substituted. 

This command is used in all debugger versions. 



#****##*##* 
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CHAPTER 6 
CHANGING OUTPUT FORMAT 

Output may be formatted in any one of several ways, using the debugger. The contents of a 

• An octal or decimal numeric datum. 

• Two numeric half words, 

• Two ASCII characters. N on -printing ASCII characters axe printed in octal code 
equivalents enclosed in angle brackets, 

• Symbolic format in which all enabled symbols are printed, 

• Byte pointer format. The first 14 bits of the word are an address that contains or is to 
receive a byte and the last bit specifies that It is either the left or right byte ( Q-left; 

1 -right). 

• .SYSTM command mnemonic format. 

• A NOVA Instruction. 

To change from one type of output to another type of output format for all future printouts, the 
general format of the command is: 



$x 



where: x is one of the following characters: 

= numeric format 
; instruction format 
: symbol format 

' ASCII format 

& byte pointer format 

- half word format 

? .SYSTM mnemonic format 

This command is used hi all debugger versions. Examples of the command are: 



$= 

START/006017 
START+1 001400 
START+2 006073 
START+3 125120 

$: 
START/6017 

START+1 DEBUG+41 
START+2 6073 
START+3 125120 

$; 

START/JSR @+l7 
START+1 JMP +0 3 
START+2 JSR @+73 
START+3 MOVZL 1 1 
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CHANGING OUTPUT FORMAT (Continued) 

Examples of the ouput formats (continued} 



START/<14 ><17 > 
START+1 <3 XO > 
START+2 <14 >; 

START+3 <252 >P 

$? 

START/ .WRB 17 
START+1 .MEMO 
START+2 .WRB 73 
START+3 125000 20 

$~ 

START/ 14 17 
START+1 3 
START+2 14 73 
START+3 252 120 



To examine a given word in another format, the location is opened and the user types the command- 



where: x_is one of the seven output formats previously described or the following: 

* symbolic format with bit set to 
For example, if the current output format mode is .SYSTM mnemonic mode, the location can 
be opened and "translated" into the other output modes as shown: 



START+15/. RDL ; DSZ +0 3 *<33 X0 > : 15400 
START+15/.RDL0 =015400 -33 &006600 *015400 



The location as well as the contents may, of course, be transliterated, e, g. , 



START+10=000773 



In this way, any expression consisting of octal and decimal integers, symbols known to the debugger 
and the + and - operators may be converted to its equivalent instruction, byte pointer format, etc. 
Thus, the = command, for example, may be used for expression evaluation. 



100+25. =000131 '<0 >Y:+131 
100+25. ;JMP +131 - 131 $000054 1 
100+25. ?. CREA 3 1 



***********. 
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CHAPTER 7 

PUNCH COMMANDS 



In SOS DEBUG only, the user has the option of using the debugger to punch all or paxt of Ms 
program. Either the high speed punch or the teletype punch may be selected for punch output by 
setting bit of the $H register (see page 8), 

The format of the command to punch all or part of a program in binary is: 



adr < adr $P 



where: adr is the first address to be punched and adr is the last address to be punched. 

The command must include starting and terminating punch addresses and the symbol < to 
distinguish the command from the break proceed commands ($P and n$P). 

Leader and trailer may also be punched. The commands to punch blank tape are: 



$F 
n$F 



where: n gives the number of inches of blank tape to be punched and may be given in either octal 
or decimal. 

If the $F command is not preceded by an argument giving the number of inches to be punched, by 

default 10 inches will be punched, 
o 

The user may also punch an end block terminating the punched program, using the commands: 



$E 

adr$E 



where: adr provides the starting address for execution of the punched program. If adr is not given, 
the user must provide a starting address via the data switches at execution time. 

The example following illustrates punching to the high speed punch 



$H 100000 

$F 

LEM<LEM+100$P 

LEM$E 

10.$F 



.— High speed punch in effect 

— Punch 10 octal inches leader. 

- Punch 101 locations starting at LEM. 
*- Punch end block with address LEM. 
~ Punch 10 decimal inches trailer. 



23 



PUNCH COMMANDS (Continued; 

When punched output is to the teletypewriter punch, the computer will halt to allow the user to 
stop and start the punch to prevent debusing commands from being punched as shown in the 

example following. 



$H 000000 - Teletypewriter punch in effect, 

6,$F Punch 6 inches leader. Computer HALTS with Carry light on. User 

presses ON button on teletypewriter and presses CONTINUE on operator panel. 

When punch stops, the computer HALTS with Carry light off. User presses 
OFF on teletypewriter punch and presses CONTINUE on operator panel. 

,X<.X3fP - Punch from . X to . X3. User presses ON on TTY and CONTINUE. When 

punching stops, user presses OFF on the TTY and CONTINUE. 

. x$E * Punch end block with starting address of . X. User presses ON on the TTY 

and CONTINUE. When punching stops, user presses OFF on the TTY and 
CONTINUE. 

|F - Punch 8 inches trailer. User presses ON on the TTY and CONTINUE. When 

punchingstops, user presses OFF on the TTY and CONTINUE. 



**#♦#**#*♦* 
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CHAPTER 8 

SAVING A DEBUGGED PROGRAM 

In the Symbolic Debugger a means is provided to save the current status of a debugged program if 

desired. The $V command allows the programmer to exit the debugger with the current state of 

the debugged program, including the current status of aU registers and patches made during debugging, 

hi RDOS DEBUG and IDEB the $V command causes a return to the CLI level wift the current state of 
the debugged program in the BREAK file. The programmer at the GLI level can then take any appropri- 
ate action. If he wishes to save the BREAK file, he can issue a CLI SAVE command at this time. 

In SOS DEBUG issuing a $¥ command causes a jump to C(USTBR)-l. If the programmer is using the 
Gore Image Loader Writer, this executes the Core Image Writer, which issues a # prompt, after which 
the programmer specifies the device and file to which the debugged program is to be written and then 
indicates the upper core address to be written (in accordance with Core Image Writer operation as spe- 
cified in the SOS User's Manual, 093-000062). If the programmer is not using the CILW, the location 
contains a -1 by default and a return is made to the debugger; the programmer may provide a jump to 
his own location outside the debugger by changing the default contents of USTBR. 

The format of the sY command is: 



$V 



Examples: 



DEB ALPHA 



$V 

BREAK 

R 

SAVE ALPHA 
R 



- Debugging commands 

- Return to CLI (RDOS DEBUG and IDEB) 

- Programmer saves BREAK file under the name, ALPHA 



DEB CT1:5 



$V 

#1:5 

NMAX: 16200 

OK 



$R 



-Debug CT1:5 

-Debugging commands 

-$V break issued 

-Old save file is specified for the new program 

-NMAX is specified 

- File has been rewritten to CT1 :5 

-CONTINUE key causes return to debugger 

-Program is started at the beginning address. 



Before issuing a $V command, the user should delete all breakpoints ($D). Otherwise, an attempt 
to debug the saved break file will result in a halt. 

Note that the $V command causes all open files to be closed. To execute the break file after issuing 
a $V, the user must provide a routine to reopen all files that were open at the time the $V was 
is.sue.i. 



#*###****#* 
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COMMAND SUMMA. 



- SOJ 



IE BUG 



Command 



__T\ i2. < -_ ' 1 : _ '■ "_" _ : " ;l 



Meanin 



j atfrj 


| Monitor Core* 


Open core location adr. 




adr/ 


j 


Open core location adr and print contents. 




) 




Close open location. 




1 




Close open location and open the subsequent location. 




t 




'. " -•'. H'k. :i i' • :.■■■.. ;■'. ' ; v '■.-.•■ \ . • ... '• / ■ : i. ■ '.. 




$A 


Monitor Accumula- 


Print contents of all accumulators, 




JJ$A 


tors 


' i'v" ' ..••:':••!■.•■• '-•,!• \(.'Y."- ■...:■■ '.;. .'.v •, • ■" - .'•! . : ' P ■. ■ .• ;•■ •, • .. 


$C 


Monitor Special 


'.»;••..: ' •. ■•..:,•.••:-. ''.-h • • < ..•'• : -/_ - i < \y : : ; •.. ■ m--. 




$H 


Registers 


Open the Search/Punch register. 




$1 




Open the Interrupt register. 




$J 




Open the Search Increment register. 




$L 




Open the Location register. 




$M 




Open the Mask register, 




$N 




Open the Number register. 




$T 




Open the Teletypewriter Input register. 




$W 




Open the Word Register. 




$Y 




Open the Svmixil Tabic Pointer Recister 




$B 


Breakpoint 


Print location of all user program breakpoints. 




adr$B 




Insert breakpoint at location adr. 




$D 




Delete all breakpoints. 




n$D 




Delete breakpoint n (n= 0-7). 




$v 


Save Debugged 


Save status of debugged program and return to CILW for possible save 






Program 


of file. 




$E 


Punch 


Punch an end block. 




adr$E 




Punch an end block, giving a starting address adr for execution. 




$F 




Punch ten inches of blank tape. 




n$F 




Punch n inches of blank tape. 




adr^adr^P 




Punch core from adr^ through adr.,. 




$P 


Execute (also. 


Restart execution from breakpoint with break proceed counter set to +1, 




n$P 


Break Proceed 


Restart execution from breakpoint with break proceed counter set to n. 




n$Q 


Counter) 


Open break proceed counter n (n= 0-7). 




$R 




Restart execution at address in location counter. 




adj$R 




Restart execution at adr. 




$K 


Symbol Enable 


Remove all local and global symbols from input/output. 




n$K 


and Disable 


Remove all local symbols from input/output but retain (or enable) globals. 




sym$K 




Remove synur>] sym [>ori output permanently. 




• name% 




Enable all local and global symbols in program name (or restore to 
output all symbols removed by $K or n$K commands). 




$S 


Core Search* 


Search all memory. 




adr$S 




Search memory from location to adr. 




adr|<$S 




Search memory from adrj to limit of memory. 




adr 1 <.adr 2 $ s 




Search memory from location adri to adr^ inclusive. 




= 


Format of Data 


Print last typed datum in numeric format. 






Output to the 


Print last typed datum in symbolic format. 




; 


Teletypewriter 


Print last typed datum in instruction format. 




! 




Print last typed datum in half-word format. 
Print last typed datum in ASCII format. 




& 




Print last typed datum in byte pointer format. 




? 




Print last typed datum in .SYSTM format. 




* 




Print last typed datum in symbolic format with bit 0=0, 




$= 




Print subsequent data in numeric format. 




$: 




Print subsequent date in symbolic format. 




$; 


- 


Print subsequent data in instruction format. 




$* 




Print subsequent data in half-word format. 




$! 




Print subsequent data in ASCII format. 




$& 




Prim subsequent, data in bvte pointer format. 




$? 




Print subsequent data in . SYSTM format. 





* Note: Under the mapping option, core examined must be within the user's address space. 

A-l 



Command 



adr ! 
adr/ 

T 



$A 



$C 
$E 
$F 

$J 
$L 
$M 
$N 
$T 
$W 
JY 



$B 

adr$B 

$D 

n$D 



$V 



$P 

n$P 

n$Q 

$R 

adr$R 



$K 

n$K 

sym$ K 

nameX 



$S 
adr$S 



$S 



APPENDIX A 
COMMAND SUMMARY - RDOS DEBUG 



Type of Command 



Monitor Core* 



Monitor Accumula- 
tors 



Monitor Special 
Registers 



Breakpoint 



Break file 



Execute (and Break 
Proceed counter) 



Symbol Enable and 
Disable 



adr < 

adr < adr„$S 
— 1 =-^-2 



Core Search* 



Meaning 



Format of Data Out- 
put to the Teletype- 
writer 



$? 



Open core location adr . 

Open core location adr and print contents. 

Close open location. 

Close open location and open subsequent location. 

Close open location and open the previous location 

Print contents of all accumulators. 

Open accumulator jj<a=0~3 in NOVA Computer; 0-7 to ECLIPSE Computer).; 

Ov- :'-j Carry Register. 

Open the Extended Save Register (USTSV). 

Print contents of Floating Point Registers. 

C-er ':'-:-c Sjjreh I.-crement Rc^isct. 

Op.,..- r;-c- L-K.itivn Roster. fUSTSA). 

Open the Mask Register. 

Open the Number Register. 

Open the Task Control Block Register (USTCT). 

Open the Word Register. 

Open the Symbol Table Pointer Register. 



Print location of all user program breakpoints, 
Insert breakpoint at location adr. 
Delete all breakpoints. 
Delete breakpoint n. (n = 0-7), 



Put debugged program in break file for possible save of file. 



Restart execution from a breakpoint with break proceed counter set to +1. 
Restart execution from a breakpoint with break proceed counter set to n. 

Open break proceed counter n (n = 0-7). 
Restart execution at address stored in USTSA. 
Restart execution at adr. 



Remove all local and global symbols from input and output. 

Remove all local symbols from input/output but retain (or enable) globals. 

Remove symbol sym from output permanently. 

Enable all local and global symbols in program name ( or restore to out- 
put all symbols removed by $K or n$K commands). 



Search all memory. 

Search memory from location to adr. 

Search memory from location adr to limit of memory. 

Search memory from location adr to adr, *«"i»e«««» 



inclusive. 



Print last typed datum in numeric format. 

Print last typed datum in symbolic format. 

Print last typed datum in instruction format. 

Print last typed datum in half-word format. 

Print last typed datum in ASCII format. 

Print last typed datum in byte pointer format. 

Print last typed datum in symbolic format with bit 0=0. 

Print last typed datum in . SYSTM command format. 

Print subsequent data in symbolic format. 

Print subsequent data in instruction format. 

Print subsequent data in half-word format. 

Print subsequent data in ASCII format. 

Print subsequent data in byte pointer format. 

Print subsequent data in numeric format. 

Print subsequent data in . SYSTM command format. 



*NOTE: Under the mapping option, core examined must be within the user's address space. 

A-2 



Comnu 



adr 



Monitc 



adr/ 
) 

f 




Open core location ^7 and print contents, | 




$A 
nfA 


Monitor Print contents of all accumulators. 

Accumulators Open accumulator n(n = 0-3) in NOVA Computers; 0-7 in ECLIPSE Ofenapptars)) 


$C 
$E 

$P 
$H 
$1 

« 

SL 

$M 

$N 

$T 

$W 

$Y 


Monitor Special 
Registers 


Open the Search .Interrupt register, 

Open the Location register (USTSA). 

Open the Mask register. 

Open the Number register. 

Open the Teletype Input register. 

Open the Word register. 

Open the Symbol Table Pointer register. 


$B 

adr$B 
$D 
n$D 


Breakpoint 


Print location of all user program breakpoints. 

Insert breakpoint at location adr. 

Delete all breakpoints. 

Delete breakpoint n. (n = 0-7), 


$V 


Break file 


Put debugged program in break file for possible save of file. 


$P 
n$P 
n$Q 
$R 

adr$R 


Execute 
(and Break 
Proceed Counter 


Restart execution :r mu a hr mnmnt wit'- brem proceed counter set to -1. 

Restart execution from a breakpoint with break proceed counter set to n. 
Open break proceed counter n (n - 0-7). 
Restart execution at address in USTSA. 
Restart execution at adr. 


$K 
n$K 

sym$K 
namel 


Symbol Enable 

and Disable 


Remove all local and global symbols from input and output. 
Remove all local symbols from input/output but retain (or enable) globals. 
Remove sym from output permanently. 

Enable all local and global symbols in program name (or restore to out- 
put all symbols removed by $K or n$K commands). 


$S 

adr$S 

adr < $S 

adr < adr_ 2 $S 


Core Search* 


Search all memory. 

Search memory from location to adr. 

Search memory from location adr to limit of memory. 

Search memory from location adr to adr inclusive. 


& 
* 

? 
S= 

$& 

$? • 
■ «■ , 


Format of Data 
Output to the 
Teletypewriter 


Print last typed datum in numeric format. 
Print last typed datum in symbolic format. 
Print last typed datum in instruction format. 
Print last typed datum in half-word format. 
Print last typed datum in ASCII format. 
■ Print last typed datum in byte pointer format. 

Print last typed datum in symbolic format with bit 0=0. 

Print preceding datum in .SYSTM command format. 

Print subsequent data in numeric format. 

Print subsequent data in symbolic format. 

Print subsequent data in instruction format. 

Print subsequent data in half-word format. 

Print subsequent data in ASCII format. 

Print subsequent data in byte pointer format. 

Print subsequent data in .SYSTM command format. 



*NOTE: Under the mapping option, core examined must be within the user's address space, 

A -3 



Command 



$A ...... 

n$A ,.,,.. 
$B ...... 

adifB ..... 

f C ...... 

$D ...... 

n$D ,.,,,, 
$E ...... 

adr$E ..... 

$F ...... 

$H ...... 

$1 ...... 

$j ...... 

$K ...... 

n$K ...... 

sym $ K .... 

$L ...... 

$M ...... 

$N ...... 

$P ...... 

n$P ...... 

adr <adr SP 
nJQ 1 ..... . 

$R ...... 

adr$R .... 

$S ...... 

adr $S ..... 

adr,< $S. . . 
adr*< adr $S 

$t 1 . . . . : . 

$V ...... 

$W ...... 

$Y ...... 

.Ki£ ; 

adr! ...... 

X ...... 

I ...... 

* ...... 

™ 9 * 

& ...... 

* 

1 ...... 

$: ...... 

$; ...... 

$ *■ 

$& ...... 

$=* ...... 



yes .................. 

yes .................. 

yes .................. 

yes .................. 

yes (Carry only) .......... 

yes .................. 

yes .................. 

yes (Extended Save register) 
no .................. 

yes (print floatingpoint registers) 



yes ........... 

yes ........... 

yes ........... 

yes ........... 

yes (TTO and Carry) 

yes ........... 

yes ........... 

yes (used in punching) 

yes ........... 

yes (used in punching) 

yes (Search and Punch) no ................ 

yes ........... no ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes (address set by user) yes (task scheduler -USTS A) 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... no ................ 

yes ....... •. ... . yes ................ 

yes (restart at C (L) ) yes (restart at USTS A) . . . 

yes ........... yes ................ 

yes ..P........ yes ................ 

yes . .'. ....... . yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

ye . ^ l • register) . . yes (TCB register) 

yes ........... yes ................ 

yes ............ yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ................ 

yes ........... yes ............... 

yes ........... yes ............... 

yes ........... yes ................ 

yes ........... yes ............... 



yes 

yes 

yes 

yes 

yt. ' ""'J and Carry) 

yes 

yes 

yes (Extended Save register) 

no 

yes (print floating point registers) 

yes (Search only) 

yes 

yes 

yes 

yes 

yes 

yes (task scheduler -USTSA) 

yes 

yes 

yes 

yes 

no 

yes 

yes (restart at USTSA) 

yes 

yes 

yes 

yes 

yes(TTI register) 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 

yes 
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APPENDIX B 

OPERATING PROCEDURES 

LOADING THE SYMBOLIC DEBUGGER UNDER RDOS 

Loading RDOS DEBUG 

RDOS users receive one of the following library tapes, each of which contains the indicated version 
of RDOS DEBUG: 

Library Tape Relocatable Binary Title of Version Associated Computer and System 

USYS. LB DEB. RB DEBUG NOVA Unmapped RDOS 

MSYS. LB MDEB.RB MDEBUG NOVA Mapped RDOS 

BSYS. LB BDEB, RB BDEBUG ECLIPSE Unmapped RDOS 

ASYS. LB ADEB. RB ADEBUG ECLIPSE Mapped RDOS 

The global /D switch of the RLDR command indicates that a debugger is to be loaded with the user 
programs. The name of the system tape itself need not appear in the command line, except when the 
user wishes to control the area of core into which the debugger is to be loaded. 

Examples: 



RLDR/D A B C ) - Load RDOS DEBUG version from library. 

RLDR/D A B BSYS. LB C) -Load RDOS DEBUG version from library before loading 

user program C. 



Loading IDEB 

RDOS users receive one of the following relocatable binary tapes, containing a version of IDEB: 

Relocatable Tape Title of Version Associated Computer and System 

IDEB. RB 
MIDEB. RB 
BIDEB. RB 
AIDEB. RB 

To load an IDEB version of the debugger, the name' of the debugger must appear in the command 
Une. If the user also names the system library tape containing RDOS DEBUG specifically in the 
command line, the IDEB version must appear first in order to be loaded. As with RDOS DEBUG, 
the global /D switch must be included in the command line: 

Examples: 



IDEB 


NOVA Unmapped RDOS 


MIDEB 


NOVA Mapped RDOS 


BIDEB 


ECLIPSE Unmapped RDOS 


AIDEB 


ECLIPSE Mapped RDOS 



RLDR/D ABC MIDEB) -Load an IDEB version following user programs. 

RLDR/D A BIDEB B C) -Load an IDEB version following A but before user programs B and C. 

RLDR/D A B USYS. LB C IDEB)-Although IDEB appears In the command line, RDOS DEBUG 

will be loaded, 
RLDR/D A B AIDEB ASYS. LB C) -Although ASYS. LB appears in the command line, the IDEB 

version will be loaded. 
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Loading Local (Usetjij y^^ 

By default, no user symbols are loaded. However, the user can load user symbols contained in one 
or more of his programs by appending the local switch /U to the name of the program or programs 
in the RLDR command line. 

Examples : 



RLDR/D A/U B/U C/U ) - Load local symbols for all user programs. 

RLDR/D A/U B C MIDEB ) - Load local symbols only for program A, 



Invoking the Symbolic Debugger 

If any version of the Symbolic Debugger has been loaded, it can be invoked from CLI level by the DEB 

command followed by the name of the save file. For example: 



RLDR/D A B/U C j - Load A, B, and C and RDOS DEBUG. 

DEB A ) - Enter the debugger to debug A. SV. 



When the DEB command is given, the debugger will respond with a carriage return/line feed, and the 
user may now proceed to issue the debugging commands described in this manual. 

LOADING THE SYMBOLIC DEBUGGER UNDER SOS 



SOS users receive one of the following relocatable binary tapes 

Relocatable Binary Title of Version 

SADEB. RB SADEB 
SAMDEB. RB SAMDEB 
SABDEB SABDEB 
SAADEB. RB SAADEB 

Loading SOS '.)LBV' • 'in.Ar Vi-netic Ta-\;/Cassctto Systems 


of SOS DEBUG: 

Associated Computer and System 


NOVA Unmapped SOS 
NOVA Mapped SOS 
ECLIPSE Unmapped SOS 
ECLIPSE Mapped SOS 



To load SOS DEBUG under a SOS magnetic tape/cassette system, SOS DEBUG must first be transferred from 
paper tape to a file on magnetic tape or cassette. The relocatable loader must be loaded into core. The 
relocatable ioa.lc:: v.\-.r\ : ; s.i'vs t'lc prompt: 

RLDR 

and the user responds by typing a command line of the format: 
OMtput-c'HX -!!_;•;.,,_. >'' >S - L ogger as er -programs 

For example: 



RLDR MT1:0/S MT0:2 $PTR/U/3 - Magnetic tape system. 



In the example, MT0:2 is the SOS debugger and the relocatable binary user programs are on paper 
tape. The local switch /U is used to cause user symbols to be loaded for each of the programs. 
Once the core image file, MT1:0, has been created, the user loads MT1:0 using the Core Image 
Loader: 



#1:0 *-User reqpests loading of MT1:0 in response to CILW prompt #. 
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Loading SOS DEBUG under Magnetic Tape/Cassette Systems ( Continued) 
The user can then invoke the debugger under the CLI with the DEB command; 



DEB MTI:0 



The debugger gives a carriage return/line feed, and the user can then issue debugging commands as 
described in this manual. 

Loading SOS DEBUG under Paper Tape Systems 

Users with SOS paper tape systems receive SOS DEBUG as a relocatable binary tape. SOS DEBUG 
is loaded by the relocatable loader, which must first be loaded into core. Once the relocatable 
loader is in core, it will give the prompt SAFE=, The user/loader dialogue to load SOS DEBUG 
is given below. User responses are underlined. 

SAFE=_)_ Carriage return gives standard save of 200 locations. 

Mount DEBUG in paper tape reader. 
*2 Load DEBUG from PTR. 

*4 Load all symbols. 

Mount user program in paper tape reader. 
*2 Load user program from PTR. 



Mount last user program in paper tape reader. 
*2 Load last user program from PTR. 

*6 Print a loader map. 

*8 Terminate load. 

When loading is terminated, the user sets the data switches to the address of the debugger, 
contained in location 406 and presses START, The debugger responds with a carriage 
return/line feed, and the user may issue debugging commands, as described in this manual. 

LOADING THE SYMBOLIC DEBUGGER FOR RTOS 

RTOS users receive a version of IDEB, which is supplied as a file of the RTOS library. RTOS libraries 
are loaded under either RDOS or SOS. 

Loading IDEB under RDOS 

As indicated in Appendix B of the RTOS User's Manual, 093-000056, the RTOS libraries are loaded using 
the RLDR command to produce a save file of user binaries, drivers, RTOSGEN and the libraries: 



RLDR/C/D user-binaries fuser-driversf RTOSGEN RTOS-libraries fffj^/jH]- ) 
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LOADING THE SYMBOLIC DEBUGGER FOR RTOS (Continued) 

Loading IDEB under RDOS (Continued) 

The /D global switch loads IDEB from the library. The load map may be obtained by listing either 
to the $TTO or $LPT, 

Procedures for executing the loaded program are given in Appendix B of the RTOS User's Manual, 
If there is no starting address given after a .END in a user binary, the user can start the debugger 
at the contents of 406 or at the DEB address indicated in the loader map. 

Leading liJl.'J Li':dv .- ' K *O z Ma.;!vu, T^pc/Cassctti- S;,sa-m 

The relocatable loader is loaded into core and issues the prompt RLDR. The user responds with a 
command line giving the files to be loaded and the save file to be created (indicated by the /S switch). 
The RTOS libraries, in which IDEB is contained, are loaded last. For example: 



RLDR CT0:9/S CT1:0... CT0;4 



When local symbols are required, the local switch /U should be appended to the user binary file in the 

load command. 

Since IDEB is part of the library, one of the user binaries must declare the debugger as external, i.e. , 

.EXTN DEBUG 
If the debugger has been extracted for loading as a separate . RB tape, it need not be declared as external. 

The save file (indicated in the load line by the /S switch) must be created. Once the save file is created, 

the user loads it using the core image loader as described in Chapter 5 of the SOS User!s Manual, 
093-000062. When the OK prompt is given by the CILW, the user places 376 in the data switches, 
presses RESET and START. This causes RTOS to initialize the system. If no starting address is 
given after a .END, the user can start execution in the debugger by starting at the contents of 406 or 

at the DEB address indicated in the loader map. 

Loading IDEB under the SOS Paper Tape System 

The relocatable loader is loaded into core and issues the prompt SAFE= . The following loader re- 
sponses and procedures will load RTOS from the $PTR. User responses are underlined. 

SAFE= ) Carriage return gives standard save of 200 words. 

Mount RTOSGEN. 

*2 Load RTOSGEN. 

Mount user drivers, if any, 
*2 Load user drivers, 

*4 Load all symbols. 

Mount user binaries. 
*2 Load first user binary. 

Mount RTOS libraries. 
*2 Load first library. 



Print a loader map. 
Terminate load. 
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LOADING THE SYMBOLIC DEBUGGER FOR RTOS (Continued) 

Loading IDEB under the SOS Paper Tape System (C ontinued) 

The order of loading is not critical, except that the RTOS libraries must be loaded last. If the de- 
bugger is in the RTOS library, a user relocatable binary must declare the debugger as an external, 
i.e. » 

,EXTN DEBUG 

so that the IDEB library program may be entered, If IDEB has been extracted as a relocatable bi- 
nary to be loaded as a separate .RB file, it does not need to be declared as an external. 

Placing 376 in the data switches, pressing RESET and START after loading will cause RTOS to 
initialize the system. If no starting address has been given after a .END, the user can start 
execution in the debugger by starting at the contents of 406 or at the DEB address indicated in the 
loader map. 
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